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1.0 INTRODUCTION 



1.0 IHI£flfiU£IICii 



Statistics provide a very powerful tool to determine a wide 
variety of things about data communications catenets. It can 
help determine if the catenet is behaving the way t ?s 
tluirlt *?J «<»«»tlfy potential or real bottlenecks and 
failures. It can provide a much needed input for the design 
of future networks and ^twork software. Statistics can also 

n p ;;:or d k e b u e s h e a f v u !o;r ttodefne " d - - ••- to c ;;,!i;: 

kinds S of C enties. CDCNET SyStemS "* co1 ,ected for * he following 

network solution - statistics about data traffic on 
directly connected networks. 

communication line - statistics concerning usage of lines 
served by terminal interface packages (TIPs). 

$ ° ft nrJicuT:; ne 2%: st « t,s *«« about the operation of 
particular software components such as Directory M-E 
and Routing w-E. 



1.1 £il&£05£ 



CDCNET Statistics Manager CCSM) exists in all DIs and provides 
Zrl?.*"* ln * erft " s /" OCNS software components and command 
Jl^r??*!^ ,n • rd I r *f°/* POft and contro « «■• collection and 
llitlll L °l •.! t lJ ,,t,c,# Indlv, <*««» software components 
collect the statistics and interface to CSM using Statistics 

perforL r ?S! U I«f, ^'l' ll™"* 9 " a ,0 " ^iorlty task, cIS 
performs the following functions: 

1) Controls the reporting of statistics; At specified time 
intervals, software component suppl led procedures are 
statistics! 6 " 61 " 816 8nd ,SSUC ,0S " ess * oes containing 

2) Manages the sampling and reporting of statistics which 
Involves keeping track of which statistics are to be 
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1.0 INTRODUCTION (Tl) 

1.1 PURPOSE * r 

collected and reported and how often. 

3) Maintains data structures which eliminates the need for 
the statistics command processors to directly interface 
the components collecting the statistics; SOSs can be 
located using statistics type and group and element 
name* 



1,2 REFERENCES 

1. CDNA GDS by J H Hart <ARH42*3) 

2. CDCNET Statistics Solution DAP by B S Sekhon (ARH65«1> 



\, ./ 



X..J * 
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2.0 FEATURE/SERVICE OVERVIEW 



2.0 ££AHl£m££Jtt£E-Ci£££itfEa 



2.1 E£Am&ESlSEm£ES 

The COCNET Statistics Manager (CSM) is a collection of program 
interface procedures and commands concerned with collecting 
and reporting COCNET statistics. In gene.'-l, software 
components concerned with statistics create Statistics Oata 
Structures CSDSs) and open SAPs to CSM. By defining SOSs, CSM 
Is forcing all software components to use consistent data 
structures to support the collection and reporting of 
statistics. The software components do the actual collection 
of statistics Into the SOS record. 

Commands are provided to control the collection and reporting 
of statistics. CSM coordinates the commands with the SDSs 
provided by the software components which open statistics 
SAPs. CSM sets a flag In the SDS directing the software 
component whether to collect statistics. The software 
component may decide to always collect statistics if more 
overhead is required to check this flag than to collect 
statistics. 

CSM controls statistics reporting by calling log message 
procedures (supplied by software components) as specified by 
CSM commands whenever statistics are to be reported. Log 
message procedures generate log messages containing collected 
statistics and call the Log Support Application to issue them. 

The services performed by CSM are listed below 

SAP Management - Statistics SAPs can be opened and closed 
and SAP entries founds In general the SAP management 
service helps create a dynamic association among CSM, 
command processors and software components. 

Statistics Control - Turning on and off the collection and 
reporting of CSM statistics white specifying a 
report/collection interval. This allows commands to 
control the collection and reporting of statistics 
without interfacing with the particular software 
components which manage them or being aware of the 
associated data structures. 
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2.0 FEATURE/SERVICE OVERVIEW """"" f 

2.1 FEATURES/SERVICES \j 

Statistics Reporting - Statistics are reported periodically 
according to time intervals specified by CSH commands. 
They are also reported when the corresponding 
statistics are started or stopped or when the 
Statistics SAP is closed. Report procedures supplied 
by the software components are called to generate and 
issue the log messages containing the statistics. 

Display Command - The display command causes the specified 
statistics to be displayed using the display procedure 
supplied by the software component. 
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2.0 FEATURE/SERVICE OVERVIEW 
2.2 FUNCTIONAL RELATIONSHIPS 



2.2 £UU£IIWUi-E£UIIQfc£BIRS 
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In the diagram above , software,, ft o pp onents use SDS records to 
pass collected statistics to CSM. The SDS record specifies a 
LSBQtt-fCQCCdVLLfi which formats the log Message containing the 
statistics data and calls the Lo p SijppQft Add! icatjQn , to Issue 
it* ££fl calls this procedure whenever a particular statistics 
is to be reported. An interface from iiA indicates to CJLfl if 
a particular log message is enabled. SOS records also specify 
Hl5BlaY,gEQC£dU£AS that format display messages containing 
statistics for £SE.&.Uala*.£flfflMADd.RLQCesSPi:s. These command 
processors are provided to control the collection and 
reporting of statistics. Via program interface procedures* 
they request ££fl to start and stop the collection and 
reporting of statistics. In order to control the reporting of 
statistics on time* CSM sets up calls from the Iliec.Iash for 
whenever particular statistics are to be reported. 
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2,0 FEATURE/SERVICE OVERVIEW 
2.2 FUNCTIONAL RELATIONSHIPS 



Command 
Processors 
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Components 






1. Program t 
Interface ♦■ 
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■♦— 



Intertask 
Message 
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Task 



V 
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3. Timer 
Interface 



— ♦ 



V 



2. 



Reporting 
Control 






CSM is made up of three parts: 

1. The program interface procedures for commands and 
software components manage SAPs and control the 
collection and reporting of statistics. They run as 
part of the callers task. 

2. Reporting Control runs as a low priority task and is 
issued intertask messages whenever particular statistics 
are to be reported. 

3. The •Tlmer.task* Interface procedure Is called when 
statistics are to be reported and runs ae part of the 
•Tlmer.Task*. However, it issues intertask messages to 
Reporting Control to do the reporting. 
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2.0 FEATURE/SERVICE OVERVIEW 
2.3 UTILIZED EXTERNAL INTERFACES 

2.3 UI I L I ZEfl.E*I£BML-IttIE&£A£ES 

Most the interfaces to Exec and Common routines such as buffer 
management are not included here. 



2.3.1 LOG SUPPORT APPLICATION 



Log message generator procedures supplied by software 
components issue log messages containing the reported 
statistics to the Log Support Application ILSA) to report 
statistics. An interface is provided by LSA to indicate if 8 
particular fog message is enabled in order that the command 
selecting statistics reporting knows if the associated log 
message will be processed. 



2.3.2 TIMER TASK 



Statistics for particular software components are reported 
periodically at specified time intervals. This Is 
accomplished by setting up calls from the Timer Task using the 
common routine *Cal l.per iodic* • One timer task call exists 
for each active Statistics SAP. 
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3-0 FEATURE DESCRIPTIONS 



3.0 EEfllUBE.BESSmiimiS 



The CDCNET Statistics Hanager (CSM) is composed of program 
interface procedures and command processors* 

Software components use program interface procedures to open 
and close Statistics SAPs and to force reporting of a 
statistics when data fields are near overflow. SAP entries 
point to SDS records which are used for collecting statistics* 

Command processors control the collection and reporting of 
statistics using program interface calls* Statistics SAP 
entries can be located using statistics type (network 
solution* communication line* or software component) and 
element names supplied by the command processors* A linked 
list of one or more SDS header records Is pointed to by each 
SAP entry. Each SDS header is defined by a statistics group 
type* Possible values for statistics group are: 

summary - normal process statistics ^ ^ 

expanded - statistics beyond normal processing 
debug - statistics for debugging 

Fields in the SAP and SDS header records are set to indicate 
whether to collect and report particular statistics* 

CSM controls the reporting of statistics by calling report 
procedures provided by the software components which collect 
statistics* These procedures generate the log message 
containing the statistics and issue it to the Log Support 
Application* The timing of reporting is specified by 
commands* CSM sets the desired interval in the SDS record and 
calls the report procedures- according to it* 



t. 
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> 3.0 FEATURE DESCRIPTIONS 



c> 






3.1 SAP MANAGEMENT 
3.1 2A£_fiA£A£E££ttI 
3.1.1 DESCRIPTION 



This feature allows software components to create and release 
Statistics SAP entries. Also* it locates SAP entries for 
command processors making it possible for them to control the 
collection and reporting of statistics. CSM uses SAP entries 
as a focus for reporting the statistics. 



3.1.2 COMMAND INTERFACES 
None 

3.1.3 PR06RAM INTERFACES 



The following program interface procedures allow software 
components to open and close CSM SAPs and command processors 
to find SAP entries. 



3.1.3.1 UfiejuSJtaJtiiiifiS-SAE 

This procedure allows a software component which Is collecting 
statistics to make itself know to CSM. The combination of 
"element.type" and ,, element«.name• , defines a SAP entry. The 
"sds.header.ptr" points to a chain of one or more sds.headers. 
Each sds.header specifies a different "group*. The format of 
the call is shown below: 



PROCEDURE CXREF3 open.stat i stics.sap ( t 

element.type: stat istlcs.type; C INPUT 

element.namet string { * J? C INPUT 

sds.header.ptr: A sds_header; C INPUT 

report.intervait l .. 60*60*24; C INPUT: Sees (2* hrs max) 
VAR sap.ld: •• 0ffff(16); C OUTPUT: Assigned SAP ID 
VAR status: open.statist ics.status) ; C OUTPUT 
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3.0 FEATURE DESCRIPTIONS A 

3.1.3.1 Open Statistics SAP \J' 



TYPE 

open.statlstlcs. status « (stat istics.sap.opened* 

stat1stics.sap_entry_exists> sds.header.not. included) } 



3.1.3.2 aflifi-SlltisUfiS-SAE 

This procedure allows a software component to close a 
previously opened statistics SAP. Note that the statistics 
for this SAP tre reported If statistics reporting was selected 
In a previous START.METRICS call. The format of the call is 
shown below: 

PROCEDURE CXREF3 c lose.s tat i stlcs.sap ( € 
sap. Id: .. 0ffff<16>; t INPUT 
element.type: stat i stl cs.typej < INPUT 
element. name: string ( * )j C INPUT 
VAR status: close.statistics.status); C OUTPUT 

type . r >j 

close.statistics.status • Cstati st ics.sap.closed* ^ -^ 

statistics.sap.entry.not.found* mismatches tat 1st ics.sap) ; 



3.1.3.3 Qltiala.S&S.&mt&as 

This procedure Is used by the statistics control command 
processor to request CSM to check if the specified element has 
an open statistics SAP and if so* to return the address of the 
first corresponding SOS header. The format of the call is 
shown below: 



PROCEDURE tXPEFI obtain.sds.address C { 

element.type: stat istics.type; f INPUT 
element.name: string < * ); £ INPUT 
VAR sap.open» boolean; { OUTPUT 
VAR sds.header.ptr: *sds.header>5 C OUTPUT 
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3.0 FEATURE DESCRIPTIONS 

3,2 STATISTICS REPORTING AND DISPLAYING 



3.2 mmLKS^£ED£Hti£-£tm-MS£LAIIii£ 
3.2.1 DESCRIPTION 



Statistics reporting and displaying is controlled internally 
by CSM. To control reporting* calls from the Timer Task are 
set up using the common routine 'Cal l_per iodic 1 • Also* 
reporting occurs when a statistics SAP is closed or reporting 
is started or stopped. Statistics are displayed when 
requested by Display commands. 



3.2.2 COMMAND INTERFACES 
None 

3.2.3 PROGRAM INTERFACES 

3.2.3.1 £££l8£££.2u££li.£4.££ > £££jiu££2 

3.2.3.1.1 BEEOBT.SIAIimCS 

A procedure* as defined procedure pointer below* is supplied 
for each SOS header by software components whenever a 
statistics SAP Is opened (see SDS header record definition in 
section 8*2. 1). This procedure is called whenever statistics 
are to be reported for the specified group. If the 'report* 
parameter is TRUE* a statistics tog message is generated and 
issued to the jog support applJjMtion* The collection fields 
are c I ear? d r e guard fes¥~^Tnn^~ T i r epp rt«\p a r a m e ! firr. ~~~ — — ■ 

" ISA 
TYPE 

report.procedure » "PROCEDURE 

sds_.hdr.ptr: "sds.header; C INPUT 

report? boolean ; C INPUT* If TRUE* issue report 

reason: statistics. reason.type; C INPUT 

time: report.time.type); CINPUT 
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3.0 FEATURE DESCRIPTIONS s-\ 

3.2.3.1.2 DISPLAY STATISTICS \±Jj? 

3.2.3.1.2 fiI_ElAI-iIAIlSIKS. 

A procedure* as defined by the procedure pointer below is 
supplied by software components for each SDS header whenever a 
statistics SAP is opened (see SDS header record definition in 
section 8.2.1). This procedure is cat led by a Display command 
processor whenever statistics are to be disiayed. 

TYPE 

display.procedure ■ ^PROCEDURE C C generates display message 
sds.hdr.ptr: "sds.headerj C INPUT 
times report.tiie.type; { INPUT 
VAR disp.msgs buf.ptrlj i OUTPUT 



3.2.3.2 auLU-It-ti- tLfiS-ttifl-tteaJkL 



The following procedure is provided by CSM to build the 
Statistics report header. The user supplied report procedure 
calls this interface to build the log message header when v J-" 

reporting statistics. ' 



/"' X 



PROCEDURE CXREF) bulld.statistlcs_msg.hdr C £ 
sds.header.ptr: *sds.header; C INPUT 
time: repor t.time.type; { INPUT 
reason* statistics. reason.typej t INPUT 
VAR log.msgx buf.ptr); t OUTPUT: partially build log message 

i 

i CDCNET Statistics Reason for Report 

t 

TYPE 

statist ics.r eason.type *- t period ic.report* s-tart.report ing# 

stop. reporting* close.sap); 
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C3.0 FEATURE DESCRIPTIONS 
3.3 COLLECTION/REPORTING 



CONTROL SERVICES 



3.3 fiflLUCIIIUU&EEOEUafi^tfaLttlU^SfimCES 

3.3.1 DESCRIPTION 



This feature provides the ability to control the collection 
and reporting of CDCNET statistics via commands. The software 
components do the actual collection of statistics* but fields 
in SDSs set by the command processors specify if the 
statistics are to be collected. In some cases* statistics are 
collected regardless of this selection since it is les«? 
"expensive" to collect the statistics than to check the field. 

Note that separate start/stop commands are provided for 
networks* lines and processes (software elements). 



3.3.2 COMMAND INTERFACES 

3.3.2.1 IIA£I-tiEIMQP^tt£I£IC.S-L-ST^a 

This command starts the collection and optionally reporting of 
statistics for the specified network solutionis! and 
groupsCs). The (collecting* field in each related SDS header 
record is set TRUE* and the reporting field in the SAP entry 
is set to the value specified in the command. Note that if 
statistics are already enabled for these networks* they are 
immediately reported and the timer that controls reporting 
restarted for the items selected. The new selection may 
specify different names* groups and/or reporting interval. 

For each specified network name* a response message is 
displayed specifying whether that network's statistics are 
started and which groups are enabled. 
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3.0 FEATURE DESCRIPTIONS 

3.3.2.1 START.NETWORK.METRICS ? STANH 



POT stanm.pdt ( 

name*n : fist of name « SREQUIREO 

group»g s list of key summary* expanded* debug* all * all 

reporter « boolean ■ TRUE 

intervals : integer 1. .60*60*24 - SREQUIRED) 

name - name(s) of network solutionis) 

group - statistics group (s) 

reporting - whether to generate report message 

interval - reporting interval in seconds ( »axl mum 24 hrs.) 

Sags ., a t - a 1 1 ,aI^lift»£imaMiafl-t£sgfliis£^aa&saflta,Aia-afl&aitl& 

Metrics started for groups <gr name(s)> on network <nw name> 
No statistics entry exist for network <nw name> 
log message <message number> not enabled 

3.3.2.2 SIfl£.ttEIHQElL-a£IEICS. I .SIPMB 

This command stops the collection and reporting of statistics 
for the specified network solution(s) and groups(s). If a 
value for the group parameter is specified* metrics collection 
and reporting is stopped only for the specified groups (others 
remain enabled). Otherwise it is stopped for all groups for 
the specified network solution. The 'collecting* field in 
each related SOS header record is set FALSE. If no SOS header 
entries for the specified SAP remain enabled* the reporting 
field in* the SAP entry is set to FALSE.- Statistics are 
immediately reported for the stopped networks. 

For each specified network name* a response message is 
displayed specifying whether that network's statistics are 
stopped and for which groups. 



C 
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FEATURE DESCRIPTIONS 
3.3.2.2 STOP.NETWORK.METRICS ! STONM 



POT stonm_pdt ( 

name*n » list of name * SRECUIRED 

group*g * list of key summary* expanded* debug* all • all) 

name»n - name(s) of network soiution(s) 

group*g - statistics group(s) 

metrics stopped for groups <gr nane(s)> on network <nw name) 
No statistics entry exist for network <nw name> 



3.3.2.3 SIAEJ-UME-CfclEICS-i-IIAlll 

This command starts the collection and optionally reporting of 
statistics for the specified communication tine(s) and 
groups(s). The 'collecting 1 field in each related SOS header 
record is set TRUE* and the reporting field in the SAP entry 
is set to the value specified in the command. Note that If 
statistics are already enabled for these lines* they are 
immediately reported and the timer that controls reporting 
restarted for the items selected. The new selection may 
specify different names* groups and/or reporting interval. 

For each specified line name* a response message is displayed 
specifying whether that line's statistics are started and 
which groups are enabled. 

POT stalm.pdt ( 

name*n : list of name » SREOUIRED 

group* g s list of key summary* expanded* debug* all * ail 

report*r « boolean * TRUE 

interval*! « integer 1.. 60*60*24 - SREOUIRED) 

name - name(s) of communication line(s) 

group - statistics group(s) 

reporting - whether to generate report message 

interval - reporting interval in seconds (maximum 24 hrs.) 
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3.0 FEATURE DESCRIPTIONS /"-> 

3.3. 2. 3 START.LINE.HETRICS I STALM ^J^ 

Metrics started for groups <gr name(s)> on line <llne name> 
No statistics entry exist for line <line name> 
log message <message number> not enabled 



3.3.2.4 UQE.LHJ£,fl£Iili:i.I.SIIlLC 

This command stops the collection and reporting of statistics 
for the specified communication tine(s) and groups(s). If a 
value for the group parameter is specified* metrics collection 
and reporting is stopped only for the specified groups (others 
remain enabled). Otherwise it is stopped for all groups for 
the specified line solution. The 'collecting* field in each 
related SOS header record is set FALSE. If no SOS header 
entries for the specified SAP remain enabled, the reportina 
field In the SAP entry is set to FALSE. Statistics are 
immediately reported for the stopped lines. 

For each specified line name* a response message is displayed 
specifying whether that line's statistics are stopped and for 
which groups. 

POT stolm.pdt ( 

name»n : list of name > $REQUIRE0 

group*g * list of key summary* expanded* debug* all - all) 

name - name(s) of communication line(s) 

group*g -statistics group(s) 

^flafti.fltLAlJ^.fl£-iiic^.flLLlojiitia res . oons e message^ Sffr BOSSLblg 

Metrics stopped for groups <gr name<s)> on line <lin« name> 

No statistics entry exist for line <line name> 



v>- 
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C 3.0 FEATURE DESCRIPTIONS 

3. 3. 2.5 START.PROCESS.METRICS J STAPH 

3.3.2.5 SIflRT,PBQCESS.tt£I£I£S-i-SIaEfl 

This command starts the collection and optionally reporting of 
statistics for the specified software etement(s) and 
groups(s). The •collecting 1 ' field in each related SOS header 
record is set TRUE* and the reporting field in the SAP entry 
is set to the value specified In the command. Note that if 
statistics are already enabled for these software elements* 
they are immediately reported and the timer that controls 
reporting restarted for the items selected. The new selection 
may specify different names* groups and/or reporting interval* 

For each specified software element name* a response message 
is displayed specifying whether that software element's 
statistics are started and which groups are enabled. 

PDT stapm.pdt ( 

name»n : list of name « SREQUIRED 

group.g : list of key summary* expanded* debug* all • all 

report»r t boolean ■ TRUE 

Interval*! » integer 1.. 60*60*24 « SREOUIREO) 

name - name(s) of software element(s) 

group - statistics group(s) 

reporting - whether to generate report message 

interval - reporting interval in seconds (maximum 24 hrs.) 

laej ar ail of thc-£al.UttiCLfl.LCSBQnsg.Bgssafl&s~aEc.gQssiblJ 

Metrics started for groups <gr nsme(s)> on sw element <se name> 
No statistics entry exist for software element <se name) 
log message <message number> not enabled 



3.3.2.6 SiaP^£&OL£SS^l£I&l£S. I - S IOEfl 

This command stops the collection and reporting of statistics 
for the specified software element(s) and groups(s). If a 
value for the group parameter is specified* metrics collection 
and reporting is stopped only for the specified groups (others 

CONTROL DAT* PRIVATE 
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3.3.2.6 STOP.PROCESS.METRICS ! STOP* 
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remain enabled). Otherwise it is stopped for all groups for 
the specified software element. The •collecting' field in 
each related SOS header record is set FALSE. If no SOS header 
entries for the specified SAP remain enabled* the reporting 
field in the SAP entry is set to FALSE. Statistics are 
immediately reported for the stopped software elements. 

For each specified software element name* a response message 
is displayed specifying whether that software element's 
statistics are stopped and for which groups. 

POT stopm.pdt ( 

name*n t list of name » $RE0UIRED 

group»g : list of Key summary* expanded* debug* all » all) 

name - name(s) of software element (s) 

group»g - statistics group(s) 

Sa me ., q c . al I . of . tli &.£AJJLttMiafl.££&ttflii&e_ne^&jaa&^axe-aa&&JLiii£ 

Metrics stopped for groups <gr name(s)> on sw element <se name> 
No statistics entry exist for software element <se name) 



3.3.2.7 SXH£HBOIlIZ£^E£I&ICS,l^Xim 

This command synchronizes the reporting of all statistics. 
Note that all statistics already collected are immediately 
reported and their report periods restarted. There are no 
parameters for this command. Only ore response is possible. 

synchronize.metrics J snym 

S£ssroose-tQ-tbe.&xachrgnize^.sQiinflad,is 
Metrics snchronize 
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3,0 FEATURE DESCRIPTIONS 
3.3.3 PROGRAM INTERFACES 



\^J 



3.3.3 PROGRAM INTERFACES 

3.3.3.1 siani_fifittia£ 

This procedure is used by the statistics reporting command 
processor to request CSM to start periodic reporting of 
statistics. If reporting is already in progress* statistics 
are immediately reported and the report period restarted. The 
format of the call is shown below: 



PROCEOURE CXREF3 s tart.metr i cs C C 

etement.type: stat istlcs.type; { INPUT 
element.names string ( * ) ; £ INPUT 
group* statistics_group_set$ € INPUT 

reporting: boolean; { INPUT: Whether to issue log msg 
report.interval: 1 .. 60*60*24? { INPUT: Sees (24 hrs max) 
VAR status: metr ics.status) J C OUTPUT 

TYPE 

metr ics.status ■ record 
•CASE started: boolean of 
* - TRUE - 

group: stati stics.group.set* 
CASEND, 
recend; 



3.3.3.2 i£jMLJl£i£JLfls 

This procedure is used by the statistics reporting command 
processor to request CSM to stop periodic reporting of 
statistics. Statistics so far collected are reported. The 
format of the call is shown below: 



PROCEOURE CXREF1 stop.metrlcs f C 

element.type: ststistics.type; { INPUT 
element.name: string I * )j C INPUT 
group: statl st I cs.gr oup.se t; C INPUT 
VAR status: metr ics.status ) ; C OUTPUT 
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3.0 FEATURE DESCRIPTIONS A > 

3.4 DISPLAY PROCESSING '^J 



3.4 nimAY.ESQCEsauifi 

3.4.1 DESCRIPTION 



Commands are provided to display the statistics currently in 
the reporting SOS data record* The accompanying display 
procedure is supplied by the software component collecting the 
statistics* Also» the responses for these commands are 
documented in the related functional ERS for the particular 
component* 

Note that separate display commands are provided for networks* 
lines and processes (software elements)* 



3.4.2 C0I1HAND INTERFACES 

3.4.2.1 illS£tiI - JlEIMCaJUl£IRI£S-UlISIH! 

This command displays the network solution statistics for for 
the specified network(s) and groups(s). 

The command response for each network specified is the display 
message (described in the particular feature ERS) or the 
message listed below (if corresponding SAP entry not found)* 

POT disnm.pdt ( 

name»n : list of name * SREQUIREO 

group.g > list of key summary, expanded* debug* all * all) 

name - name(s) of ne+work solution (si 

group - statistics group(s) 

Iii£-Xall aula a _ &cxflL_.LfiSEflQs~&~Ls...gflssiklc 

No statistics entry exist for network <nw name> 
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l\^J 3.0 FEATURE DESCRIPTIONS 

3.4.2.2 DISPLAY.LINE.METRICS \ DISPM 

3.4.2.2 fllSEUX-LliiE-ttEI£lCS.l.PIS£tt 

This command displays statistics for the specified 
communication line(s). 

The command response for each line specified is the display 
message (described in the particular feature ERS) or the 
message listed below (if corresponding SAP entry not found). 

PDT dislm.pdt ( 

name»n : list of name * SREQUIREO 

group*g : list of key summary* expanded* debug* all * all) 

name - name(s) of communication line(s) 

group - statistics group(s) 

Ihe ,f o 1 f ow I n a ., sx.LQx.-LSL2.B.&as.&-i&-2£LZ&lblt 

No statistics entry exist for tine <line name> 

3.4.2.3 fl!SPlAY.PBJl£m^£I£ICS.l..CISEa 

This command displays statistics for the specified software 
element(s). 

The command response for each software element specified is 
the display message (described in the particular feature ERS) 
or the message listed below (if corresponding SAP entry not 
found}. 

PDT dlspm.pdt ( 

name»n » list of name » SREQUIREO 

group*g * list of key summary* expanded* debug* alt ■ all) 

name - name(s) of software element(s) 

group - statistics group(s) 

No statistics entry exist for software element <se name> 

CONTROL DATA PRIVATE 
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3.0 FEATURE DESCRIPTIONS 
3.^.3 PROGRAM INTERFACES 



3.4.3 PROGRAM INTERFACES 



None- 



c 
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4.0 PERFORMANCE 



4.0 ££££Q£UA£U:£ 



The performance of Statistics Management is not critical to 
the performance of the 01 system* However* since statistics 
reporting is a low priority function* the CSM tasks run a the 
lowest priority in order not to interfere with COCNET 
performance* 

The following targets for table size* code size and 
performance are provided: 

- SAP entry size - 10 byte ♦ etement.name 

- SOS header size - 30 bytes 

- SOS data control - 10 bytes 

- SAP and SOS table space (20 SAPs/40 SDSsI - 2000 bytes 

- CSM code space 

• program i/f - 1000(16) 

• commands - 2000(16) 

- instruction count for* 

• open SAP - 1000 

• close SAP - 600 

• obtain SOS address - 300 

• start metrics - 500 

• stop metrics - 500 

• issue a report - 500 
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5.0 FINITE STATE MACHINE 



O 

5.0 EimiE-SIAIE-fiACJilJiE 



Since CSM does not have any external protocol* a finite state 
machine is not required. 
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6*0 LOG MESSAGES 



6.0 IQS„ BESIDES 



6.1 iIAIIiU£S-£££Q£I-LQ£-ll£SSAii£ 



CDCNET statistics are reported via log messages* However* 
these log messages are formatted and reported by the software 
components that are collecting the statistics. Therefore* 
they are described in the corresponding ERSs* 
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6.0 LOG MESSAGES 
6.2 NO SAP ON CLOSE 



6.2 Ufl-SA£-£il_£LflSE 



Whenever the SAP entry cannot be found for a close Statistics 
SAP call* the following log 'message is generated: 



UK-ffESSAfimi 



sme_no_sap_on_close 



g£S£&Ifimf-KESS&£E 



j 

V 



Statistics SAP entry not found for SAP ID 



UA5JS 



! MASK 



fixed text 



LQ£.aSfi.IU££££ 

L0G_MESSAGE_8UFFER_PTR* tvari abl e par t ) J 
type J value S description ! 



+ ♦ 



•sap.id * 

+ - — • — —• 



! element.type » 



i 
+• 



ielement.name » 



♦- 



bin.octet Sl..f ff f (16) JSAP ID to close j 

bin.octet JO. .2 Selement type for ! 

S Sentry to close ! 

char.octet ?1-31 chars {element name for ! 

! Sentry to close ! 

—♦♦-—-— — ------ ■- — +. .— «-— — - — —« + 



fljjcc a t fl£_£li£lfl*.£aLgai_£iafflEls 



—ERROR-- system.name system.address 83/08/04 11.00.35 30401 
Statistics SAP entry not found for SAP 10 0023 corresponding 
to element_type ■ 1 and element.name- » ESCI.NW.45 



NOTE: The date* time and originating system address are taken 
from the POU header. 
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QG MESSAGES 
6.3 NO SAP FOR TIMER 



6.3 MO.SAE_fC£.Iia£E 



Whenever the SAP entry cannot be found for a Timer Task calif 
the following log message is' generated: 



sne_no_f or.t i mer 



flESCSIEmE.flESSA£E 



Statistics SAP entry not found for SAP ID 

UASK ! : Lfl£-BSS.BUE£E& 




V. lOG.MESSAGE.BUFFEP.PTR* C var I abl e par t ) 
!! type ! value 5 description 

Mbin.octet ll-.f f f f 116) 1SAP ID not found 



-4 
-+ 
— ♦ 
— + 



o 



tjjlay_EfltBai-£xtfflfil£ 



—ERROR— system_na»e system^address 83/08/04 11.00.35 30402 
Statistics SAP entry not found for SAP ID 0023 specified by 
timer task call 



NOTES The date* tine and originating system address are taken 
from the PDU header. 
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6.0 LOG MESSAGES 

6.4 UNKNOWN INTERTASK MSG 



6.4 umuUMULUJIERIASIUlSfi 



Whenever an unknown intertask message is received by the Issue 
Statistics task* the following tog message is generated: 



lfl£,CESSA££,Ifl 

sme.unknoHn - intertask - „msg 



a£S£SI£IUt£_H£iSAS£ 






Unknown intertask message message received by Statistics 
Manager 



HAS* 



MASK 



» • 

• < 

• t 

• * 



ifl£-BSfi-flUE£££ 






!J LOG.MESSAGE.BUFFER.PTR* (variable part) 

>+ — — _- +„... ♦ —— - — --■-■ —— — - — «. 

fixed text ',', type I value : description 

message » Mbin.octet 18 bytes SThe Intertask msg 












QfiecatQC, l Oisplax-Ea£ttat.£iaiaal& 

—ERROR— system.name system.address 83/08/04 11.00.35 30403 
Unknown intertask message received by Statistics Manager 
message • 02134576 



NOTE: The date* time and originating system address are taken 
from the PDU header. 
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(3 7 '° INITIALIZAT 



ION 



7.0 luiiuuuium 



1) The Reporting Control task is started to receive 
intertask messages to report statistics* 

2) Miscellaneous variables are preset to initial values. 



9 
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8,0 NEW DATA TYPES 



8.0 KEM.PIIA,,TTPES 



W 
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•Software t 
'Component! 



{Software ! 
{Component; 

• 



V V 

JSDS SAP entry + >+SDS SAP entry 

J - statlstics.type! { - statist! cs.typ 

! - element_name ! ! - ele»ent_name 



— ♦ 
e! 



— > 



<o 




i 

v 

♦— ♦ 

JSDS Header 

! "Statistics. group* 




J 



Header 
statist] cs.gr oup ! 



V 
♦-—♦• 

:sds 



— 4 



Data 






i 
V 



V 
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6.0 NEW DATA TYPES r~\ 

P.l SDS SAP TABLE i^_J 

6.1 SiI5-5A£-IlfiL£ 

The SOS SAP Table keeps track of SAPS opened by software 
components* Its format is shown below: 




TYPE ^ 

sds.sap^entry ■ record CP^ 

sap.ldJ .• Offff(lo). A>" 

eiement.typet statl st ics.type. , 

element_name: ^string < * <* 31 )> ^ 

sds.header.ptrs *sds_beader» 

timer.id: A tin»er» 

sap.report.lnterval : 1 .. 60*60*2*# t Sees (24 hrs max) 

report.lnterval : 1 •• 60*60*2*> C Sees 124 hrs max) 

reporting: boolean* 

next.repbrting: boolean* 

report.in.progress: •• 0ffff(16)» { To lock SAP entry 

report_tlme: report. time.type* 

next«.entry: *sds«.sap_entry» 

recend* / ^^ 

statistics.type * (comm_line« -nw.sotution* sw.component); 



8«2 STATISTICS QATA STR.UCJUFF SDS 

The Statistics Data Structure CSDS) consists two parts: the 
Statistics Data Structure Header (SDS Header) and the SOS 
Data* One or more (one for each statist lcs_group) are created 
by a software component and a pointer to the first passed to 
CSM when an Statistics SAP is opened* 



! 4 7 
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8.0 NEW DATA TYPES 
8.2.1 SDS HEADER 



8.2.1 SDS HEAOER 






C 



The format of the SDS Header is identical for all statistics 
data structure. One StS # Header exists for each statistics 
group being collected. Its format is shown below! 
TYPE 

sds.header « record 
C NOTE!!! The first 7 fields Csds.buf l.ptr -> nextjieader 
C are initialized by the Software Component 

sds.bufl.ptr: j*cel I* i User defined collection buffers 

sds_buf2_Ptr: j'*cell, 

groups stat istics_group_tyoe» 

log„.msg_numbeif: •• 0ffffC16)* 

log_template_id: template. id.type* 

report.procs ifeport_ procedure* 

displ ay.proc* display. procedure* 

next.header: *sds_header* 
C WARNING!!! The following fields are maintained by CSM 
C and should not be changed by Software Component 

collecting: boolean* { Collecting statistics £ next reporting 

reporting: boolean* { Reporting statistics 

eottecting.bufl: boolean* t TRUE-bufferl FALSE* buffer2 
recend; 

statistics.group * (summary* expanded* debug)* 

report_tlme_type » record 

start* ostShms.time, { HH:HH«SS > 

ending: ostShms.time, i HH»MH:SS J 
recend; 



8.2.2 SDS DATA 



Since software components collect and report the statistics 
concerning their processes* design of the related SDS data 
buffers is left to the software component developers. Two 
buffers are to be provided for each SDS data item in order 
that one can be collecting while the other is reporting. For 
each SDS header* there may be multiple entities such as 
multiple Transport connections. 'In these cases* the developer 
may choose to provided one SDS data item for each connection. 
Note that data buffer pointers are provided in the SDS header 
record which the software component may or may not use. 
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9.0 GLOSSARY 



Li i.( 
\ -r 



^•0 £L£IIA2I 



CS*: CDCNET Statistics Manager? The name of the software 
product described in this EPS. 

SDSt Statistics Data Structure; The data structure consisting 
of an SDS header and SOS data record (described in 
section 8*2) that coordinates the collection and 
reporting of CDCNET statistics. 
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BORTS AND ERROR RECOVERY 



10.0 &BORIS AtiD-£ESQ£-£££Qy££I 



No special error recover is provided. The chances for aborts 
is minimized by carefully checking alt parameters passed in 
program interface calls. 



P 
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